Note

Introduce full ClickHouse cluster support: new table cluster config, ON CLUSTER DDL across migrations/ops, validations, TS/Py SDK updates, new templates and E2E tests, CI jobs, and docs updates.

• OLAP/CLI core:
  • Add cluster_name to Table/inframap (proto, serde) and show in CLI.
  • Generate ON CLUSTER in CREATE/ALTER/DROP/SETTINGS/SAMPLE/INDEX DDL and pass cluster through all operations.
  • Do not treat cluster_name as schema-diff; preserve from infra map during reconcile.
  • Validate databases and clusters in plans/migrations; improved error messages.
  • Handle replicated engines: auto-inject params in dev when no cluster; support cluster-aware replication.
  • Update migration schema to allow structured engine objects.
• SDKs (TypeScript/Python):
  • Add optional cluster to OLAP table config; serialize to internal model.
  • Validate that cluster cannot be combined with explicit keeperPath/replicaName (TS) or keeper_path/replica_name (Py).
  • Add unit tests for cluster validation.
• E2E & Templates:
  • New templates templates/typescript-cluster and templates/python-cluster with clustered/non-clustered tables.
  • Add E2E tests (apps/framework-cli-e2e/test/cluster.test.ts) for infra map, CH clusters, XML generation, and table creation.
  • CI: add test-e2e-cluster-typescript and test-e2e-cluster-python jobs; adjust path filters.
• Infra & Misc:
  • Docker compose supports mounting clickhouse_clusters.xml when provided.
• Docs:
  • Update configuration and model-table docs to document clusters, replication modes, and deployment guidance; note in planned migrations.

^{Written by Cursor Bugbot for commit a201fdd. This will update automatically on new commits. Configure here.}